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Technical tools liberated 

Aftershocks from Apple's corporate reorganization more than a year ago 
were felt again during August when Apple and A.P.P.L.E. Co-op (the world-wide 
users group based in Seattle that publishes Call -A^RELE, magazine), 
jointly announced the formation of the Apple Programmers and Developers 
Association, or AFDA. 

This new association, which is open to anyone who's interested, will be a 
central source for Apple development tools, including Apple's own technical 
notes, manuals, and development software, as well materials from a variety 
of third-party companies. 

Association members will receive a quarterly catalog and newsletter, 
regular update bulletins, and ordering privileges. The association will 
support both Apple 11 and Macintosh programmers. 

To join, send $20 for first year dues to the Apple Programmers and 
Developers Association, 290 SW 43rd St Renton, WA 98055. For more 
information you can call 206-251-6548. 

If this association fulfills its promise, it will be a major factor in the 
continued success of the Apple 11. To quote from the seventeen-month-old 
May 1985 issue of Open-Apple (page 34): 

Apple appears to have enough money to break through the hardware 
limitations of the Apple II and appears.., headed in that direction. But the 
rmgor question at this Juncture is wheUier Apple has enough sense to 
actively and purposefully ^expose the inner flesh" of these machines to 
interested members of the general public That is the factor that has been 
shown to determine the ultimate success of any personal computer, and 
that includes present and future models of the venerable Apple II 

It certainly impresses me to see an institution as large as Apple develop so 
much sense so quickly Mow that the developer' s association is here, look for 
a new Apple II any minute. 

Another result of Apple's reorganization 
is that if s keepmg its promise of better 
support for user groups. A new logo (left) has 
been aeated that groups can use on their news- 
letters, memberships cards, letterheads, and 
promotional materials. An 800 number (800- 
538-9696, ext 500) has been established that 
U.S. residents can call to find their nearest group. 
Apple is sending groups a regular monthly mailing 
and participates in a special user-group Porum 
tiiat is part of MAUQ (the Miaonetworked Apple 
Users Group) on the CompuServe Information 
Service. 

Apple's head of developer technical support is swapping subscriptions to 
tiie Apple 11 or Macintosh technical notes for subscriptions to user group 
newsletters. Apple's mailing list people are taking steps to ensure tiiat all 
members of user groups are included in future mailings from AppXt. Apple's 
office of special education is polling user groups to determine whetiier it can 
facilitate the exchange of information on the computer-related needs of 
disabled children and adults. 

Call Apple's 800-number today to make sure your group has made 
connections with ^ple. If you don't belong to a user group, now is a good 
time to make the connection. 

Yet another positive aftershock of ^ple's reorganization was the 
recent promotion of Del Yocam to Apple's Chief Operating Officer Yocam 




Missing No. 7 found 

Bugs in software are forgivable, but the idiot u^o numbers 
our issues (me) may never be forgiven. Last montii's issue was 
really number 7, not number 8. We have a greater appreciation now 
for how many of you save our back issues— we've been buried by 
requests for issue 7. Please help me recover from this mistake by 
marking it as Vol. 2, no. 7 right now. 



will manage not only Apple's product development manufacturing, and 
distribution operations, as t>efore, but also sales and marketing. Yocam's 
promotion is expected to allow John Sculley Apple's chairman and 
president, to focus on future directions, strategic issues, and business 
development opportunities. "My time will be focused on building j'^ple and 
Del's on running Apple," Sculley told Business Mfeefc 

Previously Yocam was head of tiie Apple 11 group, which developed, 
engineered, manufactured, and marketed all Apple 11 products. Yocam, 
whose wife taught elementary school for eleven years and who himself 
taught night classes for seven, is known for his strong support of Apple's 
efforts in tiie education market Yocam is interviewed in tiie August/ 
September issue of II Compaq ($U97/yr-6 issues, PO. Box 1922, 
Marion, OH 43306 614-383-3141). 

All is not perfect in the Apple world, however. Many Open-Apple 
subscribers in rural areas have found themselves witiiout a local supplier in 
the wake of Apple's recent reduction of authorized dealers. In this case 
Apple's purpose seems to be in the right place— it wants to develop dealers 
v^^o will concentrate on specific markets, learn them inside out and support 
tiiem with all their hearts. 

Rather tiian keeping the dealers whose salespeople knew AppleWorks 
from /^ple Writei however, App\t seems to have kept tiie ones who had the 
highest sales volumes. A dealer who knows tiie Apple product line and who 
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can demonstrate a half-dozen software packages is a precious and valuable 
thing. Apple knows that and says it wants all of its dealers to be like that yet 
every couple of years we see a bloody dealer purge based on other 
standards. 

Apple painted itself into a comer several years ago when it cancelled its 
agreements with all dealers who were selling by mail order. The real reason it 
did this was to appease dealers viho were mad about some big mail order 
houses that were selling high volumes of machines at low prices. However, to 
appease end-users mad about losing a low-cost source of machines, Apple 
said it was cutting off mail order dealers because they didn't provide high- 
quality technical support 

This is ludicrous. The level of technical support you get from a dealership 
has nothing to do with whether you contact it in person, by phone, or by mail. 

For exan^le, the best dealer youH find for portable ^ple lies is 
Roger Coats (P.O. Box 171466, San Diego, CA 92117 61^274-1253). Roger 
specializes in and stocks for immediate shipment C-Vue LCD displays, 
carrying cases, battery power systems, cigarette lighter adapters, and 11c 
modems, clocks, and memory boards. There is no one at Apple itself or at 
any other dealership in the country with as much information on the 
products that are available for making a lie truly portable. 

This kind of support for specialized markets is only possible from dealers 
vMo consider their marketplace to be country- or world^vide and wdio, as a 
consequence, deal with customers by phone and mail. 

Likewise, so few store-front dealerships have been able to provide decent 
support for people interested in programming tiiat as mentioned earlier, 
Apple has had to form a "strategic alliance" with a user ^oup to provide this 
support by . . . shhhh , . . mail order. 

More, not fewer, specialized mail order dealers are badly needed. Many 
Open-^piesubsolbersJor example, would appredate a dealer specializing 
in statistical analysis software. Imagine being able to make one call to find 
out the dieapest way to outfit a 16-computer lab with software for a class, or 
to find out if a specific package works with unequal n and what it does about 
missing data. Could such a dealer possibly operate any other way than by 
phone and mail? 

The rural areas of the world already have enough problems without having 
to worry about where the/ re going to buy their next Apple II. Apple has every 
right to insist that its dealers support its products but when is it going to 
wake up and select its dealers on that basis, rather than on easy-to-measure 
but mindless criteria sudi as method or volume of sales? 

J^ple AssemMy Line ($18/yr P.O. Box 280300, Dallas TX 75228 
214-324-2050) has come up witii a great exaiiq>le of using sound to 
analyze data, a topic discussed here briefly in March (page 2,9). In AAL's July 
issue. Bob Sander-Cederlof uses short tone-through-the-speaker subroutines 
to determine how many "machine q^Ies" certain 65816 machine language 
instructions take to execute. Of course, this kind of information is in the 
standard reference manuals for the chip, but it turns out that for some of the 
instructions some of the standard references are wrong. 

Determining how many cycles an instruction takes can be tedious work. 
The typical method is to write a loop that will run millions of times. Then you 
use a stopwatch to figure out how long the loop takes both with and without 
the opcode under examination. Subtract the shorter time from the longer 
and divide by the number of loops. Multiply by a conversion factor that 
changes millionths of a second into machine cycles and you've got it 

Instead of this rigamarole Bob simply created a continuous tone-loop that 
included an opcode M^ose number of execution cycles he was certain of. 
When he pressed a key, control passed to a duplicate loop that included the 
opcode under examination instead. If the pitch of the tone changed, the 
numl)er of cycles used by the new opcode was different (higher pitch meant 
fewer cycles). ' 

Using this simple program. Bob figured out that the branch-long (BRL) 
instruction takes four cycles, rather than the three cycles claimed on the 
manufacturers' data sheets; and that the branch-always (BRA) instruction 
takes three or four cycles (depending on mode and page crossings), rather 
than the two claimed by the manufacturers. Don't overlook the power of 
sound in your own programs. 

When I keep mentioning the same software package over and over 
here in Open-Apple, its because it's good. Qlen Bredon, author of the Merlin 
assembler, (521 State Road, Princeton, NJ 08540) just keeps adding features 
to his $40 FROSEL package. If you have a hard disk, or if you are using a 3.5 
inch disk in conjunction with a RAMdisk, this package is invaluable. 

As mentioned before, the basic package is a program selector that runs 
automatically whenever you quit a ProDOS program. Leave AppleWorks, for 
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example, and your own menu of available software instantly appears on the 
screen— no prefix or pathname required. 

The program selector has become only a small part of the software on this 
disk, however. In addition there's a program for backing up and restoring 
ProDOS devices (including the ability to backup the contents of a RAMdisk 
into a file that can be automatically reloaded into the RAMdisk on startup); a 
RAMdisk driver for auxiliary slot cards; a program for copying, deleting, and 
otherwise maintaining files (including a directory sorter that works); a fast 
disk copy program; a disk zap program; a simple password protection 
program; a program for putting DOS 3.3 into a ProDOS file; UMO.DOS, which 
allows 3.5 inch UniDisks to be used as 140K DOS 3.3 disks (with the rest of 
the disk left for ProDOS); a patch for Pinpoint that allows it to be used with the 
program selector; BEACH.COMBER, a program that rearranges a hard disk 
so all directories and files lie in contiguous areas, which speeds up file 
access; MRFIXIT, a program that checks out all the directories on a ProDOS 
volume, looking for more than a dozen kinds of enrors, and fixing those it 
finds; and, as th€y say, more. 

If youVe been neglecting to enhance your He, or if you sometimes 
wish you hadn't you may be interested in a device called Switchback ($59.95 
+ 2.50 shipping. Computer Accents, P.O. Box 5905, Kingwood, TX 77325), 
This is a small board witii six sockets, four for the old and new Monitor ROMs 
and two for the old and new video ROMs, \Mch plugs into your motherboard. 
It has a built-in switch that determines whether your computer normally 
starts up with tiie old or new ROMs and it has an external switch you can 
press vihik power is applied to start up tiie alternate set 

I suspect tiie device will be of particular interest to software developers 
viho want to test tiieir work on both original and enhanced lies, but v^^io 
would like to avoid having an extra machine around. Thaf s why I bought one, 
anyhow. It works as advertised. 

A few notes: you do have to turn the computer ofl'to switch from one ROM 
set to the otiier. You do need both sets of chips — they are not supplied with 
Switchback (you kept your old ROMs as recommended in Open-Apple May 
1985, page 38, ri^t?). Switchback isn't compatible with European-type 
motiierboards that have the auxiliary slot in line witii slot 3, nor with any of 
tiie motherboard-based 65816 or Z-80 cards we've hied. There is also a 
potential conflict witii any long card in slot 5, 6, or 7 tiiat has a "support foot" 
or tiiat otiierwise protrudes below the normal height of a card. 

A little over a year ago Uncle DOS got a question about how to 
transfer ^ple 11 graphics to T-shuts. Plot knowing the answer, and being 
pretfy sure he never would, he filed tiie letter in the circular file. Flow, oh 
gentie questioner, we sure hope you renewed your subscription because we 
have an answer. 

What you need is an Underware Ribbon from Diversions (505 W Olive Ave, 
Suite 520, Sunnyvale, CA 94086 408-245-7575). These ribbons are available 
for most dot matrix printers. You print your graphic on a piece of erasable 
bond paper using the Underware Ribbon, then you transfer the graphic from 
the paper to cloth (50-50 cotton-polyester fabric recommended) with an 
iron. The instiiictions recommend using an image no larger than twice the 
size of your iron. 

Prices vary by what kind of printer you have, but for the Imagewriter, for 
example, black ribbons are $14.95, single color ribbons are $16.95, a multi- 
color ribbon for tiie Imagewriter II is $24.95, and a black ribbon witii 5 pens 
of various colors (to be used with manual color-fill subroutines) is $24.95. A 
single ribbon is good for 30 to 100 images, depending on how much ink is 
used by each image. 

The Academic Courseware Exchange (4141 State St, Santa Barbara, CA 
93110 800-235-6919, 800-292-6640 in CA) has just published a free catalog 
of programs for use in college and university courses. The purpose of tiie 
Academic Courseware Exchange is to provide a means whereby students 
can obtain course software just as they now do textixx)ks. 

Faculty members who decide tiieyd like to use a program in their class are 
supposed to make arrangments witii a local Kinko's photocopy center to 
order the software. Students then go to Kinko's to purchase the software, 
which is priced between $7 and $30 per package. If tiiere's no Kinko's store 
near a particular school, Kinko's headquarters will an-ange to deliver tiie 
software tiirough a local bookstore. 

Faculty members who have developed courseware tiie/d like to see listed 
in the catalog should write or call the courseware exchange and ask for a free 
developer's handbook. Kinko's handles production, distribution, and 
marketing of the software and pays a royalty based on sales. Any subscribers 
who develop for or buy from tiie exchange are encouraged to let Uncle DOS 
know lA^at tiiey ttiink of it 
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Dual custom printers 

There's more than one way to set up more than one 
custom printer in Apple\lforii5. What I did was make a 
duplicate of the 9-block SEQ.PRfile on the ApplellSlbrks 
disk. I named the two files SEQ.FRiMTERl and 
5EQ.FRirfrER2. Then I wrote an Applesoft startup 
program that asks v^ich printer I want to use. The 
appropriate file is renamed SEQ.PR and AppleWorks 
is loaded. To switch printers you have to exit Apple- 
Works, but that doesn't boto me. Here's my startup 
program: 

3000 REM Hult J -Custom Printer Startup Prograni 

4000 TEXT : HOME : NORNRL : D$:=CHRS(4) 

4100 REM If present, rename SEG.PR 
4110 DNERR GOTO 4130 : REM duplicate filenaie trap 
4120 PRINT DI;'RENfiME SEG.PR, 5EG.PR1NTER.1* 
4130 ONERR GOTO 4150 

4140 PRINT DSrRENAMC SEG.PR, SEG.PRINTER.2' 
4150 POKE 216,0 : REM cancel ONERR 

4200 PRINT 'PRINTER ttl OR tt2? : 

GET m : PRINT fl$ 
4210 IF fl* <> '1* fiNO ft$ <> "2* THEN END 
4220 IF R$=''l* THEN 

PRINT D$;-RENfiME SEG.PRINTERl, SEG.PR* 
4230 IF fl$='2' THEN 

PRINT DSrRENflME SEG.PRINTER2. SEG.PR* 

4240 ONERR GOTO 4260 

4250 PRINT DJr-fiPLUORKS. SYSTEM" : END 

4260 PRINT Oir-MPCRQ. SYSTEM" : REM for MacroWorks 

Bert Kersey 
Beagle Bros 
San Diego, Calif. 

Mail label musings 

I haven't been able to find a software program to 
use with my computer that will work with pressure 
sensitive mailing labels. The programs I have seen alt 
printout in a single column of labels [only one label 
wide). Using such a program will require the purchase 
of a special tractor modification for my printer. Please 
advise me on how to proceed with this problem. 

IA.Dumetz 
Los Angeles, Calif. 

You bring an interesting problem. Standard 
one-Me pressure sensitive labels can't be used 
u^Ui several of the prir^rs conmmly found hooked 
to Apple //s. On the Apple Ima^ewriten for example, 
the tractor wheels can't be mooed close enough 
together to accommodate standard labelis. 

/m£^eu7riterou7ner5 can eas&y solve their problem 
however, with extra-unde one-up labels. For example, 
Moore Bu^ness Products (P.O. Box 20, Wheeling, III 
60090 800-525-6250) stocks one-up pressure sensi- 
tive labels in seven different widths from 2.5 inches 



to 7. 75 inches. The narrowest ones that uM work on 
an Imagewriter are 4 inches wide. We've used Uteredly 
thousands of them here at Open-Apple. 

Some other printers, including many Epsons, 
have tractors that are only barely (or not at all) 
a^ustable. A possibility in U^is situation is a program 
called Muse Address Book, which will print labels 
from 1 to 6 across. Muse so^are entered bankruptcy 
in September 1985, but its assets were eventually 
purchased by another company, which is now 
selling and supporting Muse's products. The retail 
price of the Mu$e Address Book is $49.95, but a 
hefty dismmA is avaOabk if you call or write Muse 
Software, Damascus Centre, Damascus, Md 20872 
301-255-5553. (Thanks to su/mfber Doug Brower 
in OshkosK Hto. for Muse's new address,) 

One important thing we fiaoe feamed about pres- 
sure senstHoelabdshereatOpen-Apple, incidentally, 
istoneverrollthembackumdsthrough yourprinter. 
When you finish using them, (ear off the unused 
labels behind the printer and roll the remainingones 
forward through the printer. This wastes a few labels 
but is far better than having a label get stuck 
underneath your printer's platen, Thisoften happens 
when rotiir^ the labels backward and usually requires 
taking the printer apart to get the wayumd label 
unstuck. 

Disk resurrection 

Is there a way to bring back an AppleWorks data 
disk that has crashed? 1 did not update my backup 
disk and the Information that is on this disk is 
extremely important to me. I would appreciate any 
assistanceyou could offer. 

MehnnKatz 
Dmt,f\a. 

AK yes, the old disk<rash problem. 

First examine the troublesome disk for physical 
dam^e. Will the magnetic media rotate freely inside 
the cover? Is the cover crimped or heat damaged? 

something spilled on the disk? Problems such 
as these can sometimes be solved by cutting open 
the disk cover on both the damaged disk and on a 
good disk, CarefuUy remove the rm^tic media 
from both disks. Clean the damaged media (if 
netxssary) and place it in the undamaged cover. It 
may now be readable. If so, make a couple of copies 
of it and throw the damaged material away. 

If the disk's problem isn't physical dam^e, a 
likely problem is bad centering Inside the disk drive. 
Start up AppleWorks and tell It you want to add a file 
to the desktop. Before telling it where the file is, open 
the door on the disk drive that holds the damaged 
disk. Then tell /^pleWorks which disk the file is on. 
The disk drive light will come on. At that point close 
the drive door. Gosit^ the drive door while the disfc 
is spinning is the best way to get the disk propeiiy 
centered. 

If your lost file still won't load, try putting the disfc 
in a different drive and repeat the procedure. When 
disk drives start to get out of alignment, the primary 
symptom is that disks written on one disk drive can't 
be read on anther. Ms^e sure you try to read the 
troublesome disk using all of your uarious disk 
drives. 

If you fiaoe stiU have had no luck reading the disk, 
you should at least know by now whether the 

damage lies in the disk's directory or in the file itsdf 
If Apple)^rks will show you a list of the files on the 
disk but coughs while loading the one file you really 
want, the file is bad. If^pleWorks won't even show 



you the list of Uie files on thedisK Ike directory is 
bad. 

In either case, the next step is to put a wrUe- 
protect tab on the bad disk and try to make a copy 
of it. Start with the COPYA program from the DOS 5.5 
System Master disk if you have it Boot DOS 5.5 and 
hand-enter POM 47426,24. This defeat some DOS 
3.3 error-checking. Then KVfi COPYA and attempt to 
copy the bad disk. If the copy succeeds, startup 
AppleWorks and try to load your files from the copy. 
This trick will sometimes recover disks that have 
been through a drive that was slightly off-speed. 

If you've gotten this far without success, it's time 
to buy yourself a copy of Bag of IHcte 2 ($49,95 
plus shipping from Quality Software, 21610Lassen, 
n Chjaisworm, CA 91311 818-709-1721). Bag of 
JMssl isasetof four programs deigned specifically 
to help you recover damaged disks. First concentrate 
on the program IHIT— use it to make a copy of your 
damaged disk. 

If your problem is a damaged file (rather than a 
damaged directory), try loading the file off of the 
new disk that ItilT creates. If the problem is a 
damaged directory, on the other hand, use the 
program FIXCAT to massage IWTs copy. FIXCAT will 
scan the disk and attempt, often successpiUy, to 
rebuild the bad directory. 

If you get this far and still have had no luck, you're 
In pretty deep, 

Dennis and I have tossed around the idea of 
offering a data-di^ recovery sewice (HOT to include 
Ci^yprotected program disks) forafee—say maybe 
$50, We have the needed hardware, software, and 
&q)ertise—all we need is the Ume, Is such a service 
needed? flow much is it worth? Is there already 
somebody out there doing this that we don't know 
about? 

DIFiculties revisited 

1 read with much interest and empathy Douglas 
Sietsema's August letter (page 2.56) about the difficutfy 
of moving a VisiFile data base to AppleWorks with DIF 
files. Having spent many long hours trying to do 
almost exactly the same and a few other things, I 
really felt sony for him. 

Hot only did I finaliy accomplish a VisiFile to 
AppleWbrl^ transfer— aboutayear later I transferred 
the data from AppleWorks to a Macintosh program 
called Oi;erviem In each case 1 eventually determined 
that at least part of the problem was that the DIF file 
had to be converted from column format to row 
format 

Having some experience with Advanced VisiCalc, 1 
knew that it allows a choice of saving DIF files in either 
a row or column format That was the key I read Uie 
l/isiflie DIF file into Advanced WsiCa/cusinga column 
format Then I resaved ft using a row format Then 1 
converi:ed the file to ProDOS and AppleWorks read 
the file correctly. Going from AppleWorks to the 
Macintosh again required a side trip through DOS 3.3 
and Advanced VfeiCa/c 

David Q.Story 
SauftSte, Marie, Ontario 

/ suspect ^our side trips through Advanced Vis- 
iCalc did more than ^mply convert your DIF /He 
from column format to row format It also got rid of 
the additional header items I mentioned last month, 
I also suspect you could use just about any spread- 
sheet that supports DIF files (with the exception of 
Apple)/\torks) to clean up and reformat your DIF files. 

As you point out, the AppleWorks database gives 
you no opportunity to specify row or column formal 
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when loading or saving DIF files. Howevei the 
AppleWorks spreadsheet does present you wiUi a 
choice when printing (saving) DIF files, 

If the only problem with a DIF file was that its row- 
column format had to be reversed, you could do it by 
passing the file through the AppleWorks spreadsheet 
as well as through Advanced VisiCalc. 

Incidentally, to get a file to appear on the multi- 
record database screen in the same order that it 
appears on the spreadsheet (records in rows, cate- 
gories in columns), you must use the colunm format 
when prinUng (saving) the DIF file. This is kind of 
odd, since the default is the row format Limited 
testing here indicates that if you haue more than 50 
categories in a DIF file the AppleWorks database 
simply lops off the extra ones— it doesn't refuse to 
load the file. 

Cartoon reprints 

How can I obtain the rights to reprint a cartoon that 
appeared in your newsletter? 

L J. Lynch 
Fort Worth, Texas 

All of the Open-Apple cartoons published to date 
have come from the same artist Contact him directly 
for full information— he dmges by circidation size 
and has very reasonable rates for small publications, 
tie is Rich Tennant 95 Forest Hills, Apt H Jamaica 
Plain, Mass. 02150 617'522-082l 

Open-Apple welcomes submissions of Apple 11- 
related material from any cartoonist. 

DOS 3.3 text file length 

I had the problem recently of having to combine 
about a hundred different sequential text files into 
one compact file. Each small file consisted of a 
combination of numbers and strings. I ended up with 
the inelegant solution of converting each small file to 
all strings, adding up the LEFt of the strings, throwing 
in a dummy string, and saving all that to the main file. 
Then I'd save the next file using the location of the 
dummy string (i.e. WRITE FILE, Bxxx; where xxx is the 
byte number of the last dummy string). 

With a few fits and starts it eventually worked, but 
the question I want to ask eluded me in any research I 
tried to do. namely, operating under DOS 3.3, how 
can you ascertain the number of bytes in a text file? 
Isn't there some nice convenient FEEKjust waiting for 
me to learn its address? 

Jim Menick 
Peekskill,ri.Y, 

TTiere is no magic PEEK to determine a text file's 
length under DOS 5.5. DOS simply doesn't know 
how many bytes are in a text file. If you must know, 
the only way to find out is built a GET loop and count 
the characters until you hit an EliD OF DATA error. 

In your case, it might have been easier to use the 
DOS 5.5APPFnD command to tack succeeding small 
files onto the end of your msdn file APPH1D works 
just like the OPEIi command, but it puts the position- 
in-file pointer at the first byte beyond the end of the 
file rather than at the beginning of the file. The DOS 
5.5APPE!iD command has some bugs, however (all 
solved in the March 1985 Open-Apple, page 24). In 
addition, using APPEtiD in an appUmtion like this 
would become quite slow as your main file got 
larger, because each time you execute APPEUD it 
determines where the end of the file is by reading the 
file byte-by-byte until the end pops up. 

ProDOS, on the other hand, remembersthe number 



of bytes in text files. The information is in the 
diredory and can be seen by using the 80-column 
CATALOG command. The Ba^csystemAPPEtiD com- 
mand uses this information to go directly to the end 
of the file and is consequently much faster than DOS 
5.5'smrmon. 

BLOADing DOS 3.3 text files 

\a\ Qolding asked in your February 1986 issue 
(page 2.6) for a way to BLOAD a DOS 3.3 text file, as 
under ProDOS. Here's one solution: 

Before calling the routine below, ADR should equal 
the load address, and FILE$ should equal the name 
of the file loaded: 

100 REM *»* Routine to 'BLQRD' a text file «** 

101 REM * 

102 REM * set flOR and FILES before entry 

110 PRINT : PRINT CHR${4) rOPEN '';FILE$;M256* 

120 DB=PEEK(4G535) + PEEK(4G53G)«25G + 79 

130 P1=PEEK(DB) : P2=PEEK(0B+1) 

140 POKE DB+l,flDR/25G 

145 POKE DB,flDR - (PEEK(0B+1J * 256) 

150 FDR REC=0 TO PEEK(4G574)'2 

1G0 PRINT CHR$(4);"REflD";FILE$;',R'';REC;",B0" 

170 GET flJ: PRINT 

180 POKE OB+1. PEEK(DB+1) + 1 

190 KEXT REC 

200 PRINT CHRS [4); "CLOSE"' 

210 POKE DB,P1: POKE DB + 1,P2: REM restore pointer 
220 RETURN 

The routine works by fooling DOS into thinking its 
data buffer is at ADR, rather than above HINEN as it 
usually is. Lines 150 to 190 load the file into memoiy, 
one sector at a time, while moving the apparent 
location of the DOS buffer higher for each sector. An 
important element of this trick is setting the record 
length to 256 {the length of a sector) and using GET 
to force DOS to read the next sector into the biifer. 

Drawbacks? Sure, only sequential text files can be 
loaded since the GET command will cause an END OF 
FILE error if it finds empty bytes in a random access 
file. The routine loads whole sectors at once so any 
unused bytes at the end of the last sector will 
overwrite as many as 254 bytes in memoiy. DOS text 
files are stored and, with this routine, loaded with the 
high bit set which may not be compatible with your 
routines. Still, it has its uses, and doesn't require any 
machine language. 

Flrank Q.Andrews 
Kalamazoo, Mich. 

found group FOfYTH 

Reference your mention of FOKTH, (page 211), 
March 1986, Open-Apple, fast it is! But the notation, 
Polish, never for me has been a problem! liore 
natural, what could be? For years, using it I have been. 
The FORTH Interest Group, P.O. Box 823X San Jose, 
Calif 95155, interested readers should write. 

Anthony D. Alley 
Eldorado, Texas 

Applesoft compilers 

It seems to me ttie reasons listed in your June 
issue (page 2.39) for not developing a ProDOS-l>ased 
Applesoft compiler are really arguments against 
production of an inadeguate compiler. 

Speed is addictive, and I have yet to hear anyone 
complain that a given combination of hardware and 
software runs too fast So the existence of other 
improvements that make programs speedier hardly 
renders compilers obsolete. 
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Since most of my own computing consists of 
various calculations ! need for my physics research, 1 
don't need to look far for program tjottle-necks— 
floating-point arithmetic is inevitably what slows my 
programs down. I've already found out that Miaosofts 
DOS 3.3-based TASC compiler doesn't speed these 
calculations up at ail. What's more, ZBasic does them 
more slowly, even with precision configured to fewer 
decimal digits than Applesoft I'm unaware of really 
fast floating-point routines that one can insert into an 
Applesoft program. The floating-point boards from 
California Computer and Applied Informatics provide 
speed at the expense of precision and they're not 
cheap. So far. Applied Engineering's TVanswarp board 
offers the easiest way to make my calculations go 
faster (ten minutes to do certain integrals instead of 
half an hour). 

The one thing I envy IBli (and IBM clone) users is 
their option of simply plugging an 8087 chip into a 
socket to obtain dramatic improvements in floating- 
point performance. To be sure, an 8087 is not cheap 
as chips go, but it still costs less than accelerator 
boards and much less than floating-point boards. 
Still, my Apple does so much else well that I'm willing 
to walk away and let it chum out calculations in its 
own good time. 

What the Apple II needs more desperately than a 
good compiler is an improved Basic. For all the 
wonders that clever Apple users have managed to 
bring us, from named subroutines with local variables 
to neat screen management commands,^plesofl is 
not up to snuff anymore. Reliable and fast floating- 
point arithmetic, multi-line functions, nice long 
variable names (with all characters significant of 
course)— these and other features ought to be 
brought into standard Applesoft The language that 
was great on 48K or smaller-capacity machines in 
1980 is too confining now. Even j^icrosoff s QW BASIC 
for MS-DOS machines is better. 

Harvey S. Picker 
Hartford, CT 

/ agree, Applesoft is a limited language compared 
to ddmost everything else in use today. On the other 
hand, it has two strong points — it is readily available 
on almost every Apple U ever manufactured and it's 
easy enough to learn that almost everyone who is 
interested in Apple lis and programming understands 
it 

This universality, unfortunately, ma/ccs it impos^e 
for Apple to update the language. An updated Apple- 
soft would simply not be Applesoft The incompati- 
bility problems that would inevitably arise would be 
worse than the limitations of today 's Applesoft 

I expect Applesoft to be our universal language as 
long as there are J^ple lis, but I also expect to see an 
explosion of more advanced languages for the Apple 
II during the next 18 months. Already we have J^^an 
Pascal, IBasic (which you mentioned), and Micol 
Basic (which comes up in the following letters). 
More languages are on the drawing boards. 

Besides being universal, Applesoft continues to be 
an excellent language for beginning programmers. 
It is a good, productive environment for learning 
about computers in general. I don't buy the widely- 
promulgated opinion that Applesoft gives begfnners 
"bad habits," Wiat is the best way to learn the 
importance of good program structure— by being 
forced to use structure without explanation or by 
writing programs with poor structure and then being 
forced to enhance them? Letting students crash into 
Applesoft's limits is the best way to teach them the 
advantages of more advanced languages. 
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And, as I said, advanced languages for the Apple U 
are suddenly budding out all over. Meanwhile, here's 
a bud for you. 

According to a reliable source, our friends at 
Beagle Bros fwm a ProDOS-basedApplesoft compiler 
underdevelopment The source. Uncle Louie, says it 
will compile any reasonable Applesoft program, 
although some ampersand commands will have to 
be changed. It works by simply adding a COMPILE 
command to your progmmmir^ emilmnment You 
typeCCMILEnLEtW^ andipurAi^itesofiprogmm 
uM be comfMed and executed on the spot You can 
also type COMPILE Plimm mVfllLEimE and a 
compiled version of the program wiU be stored in a 
file with a special file type. Unde Louie says the 
compiled file is usually shorter than the original 
Applesoft file. 

Compiled files will be able to be distributed as 
commeraalsoftware. They will require the compiler's 
''run fime 'pacfeage, howeuer, which will be Ikensable 
from the program's author, Alan Bird. Uncle Louie 
says he thinks the program will sell for $74.95 and 
will be available just before Christmas. 

LIST protection 

I've enclosed an ad fifom CaII-Af^EL£concernlnga 
compiled Basic for the FroDOS environment called 
Micol Basic The ad is a bit enthusiastic, but not too 
far from the truth. 

Mow, about your statement in the June issue 
concerning what half the world Uiks about compilers 
and LIST protection... 

I develop custom software for vertical markets like 
TV studios and audio^sual producers. Compilers, 
such as Micol Bade art some of my most important 
tools. I compile because it reduces program develop^ 
ment time (compared to using machine language) 
and the code runs fiaster that any interpreted Basic. 
Since most compilers offer chaining, I Ve never had to 
be too concerned with code expansion. I'd rather 
develop and debug modules anyway. 

And man^ng dozens of utilities that all compete 
for the ampersand vector stopped being fun a long 
time ago. Besides, most of these utilities are copy- 
righted and give me no legal right to use them in 
software I develop for sale. 

( By the way, I debug the Applesoft before compiling. 
There's no reason to have to compile over and over 
again.) 

But the main reason 1 compile is for my own 
protection. This means including a front page in the 
program tiiat states my copyright Uie name and 
address of the licensee, and the terms of the license. 
If the program is copied, this information goes along 
with it I've discovered that folks are very protective of 
software that can be traced back to them. 

As a developer, I owe my clients workable object 
code that they can badi-up for their own safety I don't 
feel that I owe them the right to get into my source 
code and remove what little protection I have. 

Frank Jaubcrt 
Houston, Texas 

Embedding a purchaser's name within a copy of a 
programisanunobtrudvecopy-protedion technique 
that is ideal in situations where you know who your 
customers are. / like it. If I were concerned about 
illegitimate copies, however, I would encrypt the 
purchaser's name so that it couldn't simply be 
dmged to Nsad&u^ a disk zap program. Compi- 
lation isn'tstricUynecessary—anampersand routine 
or even some obscure Unes of Basic would protect 
the embedded code nearly as weU. 



MicolBask 

In the June issue of Open-Apple Robert Heldretii 
asked about ProDOS compilers. 1 am not aware of an 
Applesoft compiler for ProDOS but there is a program 
that I recentiy purchased that just about fills the bill. 
The program is Micol Basic 

Let me preface my impressions of the program 
wiUi the caveat Uiat I am not an expert I bought my 
first Apple in (1 was 45) and taught myself to 
program witti The Applesoft Tutorial With the help of 
magazines such as JYibAfe, SoftaUtand others I have 
been able to write spedacularly unsophisticated 
programs for my own amusement and amazement I 
gave up on assembly language. Here's what 1 think of 
Micol Basic 

I found the manual veiy well done but a few more 
examples would have been helpful. Especially If/ 
THEMBEQin/ELSEBEQITi. 

I like the added commands, such as FX)R/unTlL, 
PERTORM/UrmL, REFEAT/UrfTIL, WHILE/WE«a IF/ 
THEW/ELSE, and the ability to GOSUB/ROUTIHE 
rWlE rather than QOSUB/LIHE liUMBER. I think that 
tiie Micol disk commands, i^diich don't use control-D, 
are superior to Applesoft. 

Compiling your programs to /RAM is veiy fast It 
took me awhile to figure out how to do it but with the 
help of PROSEL, a tenrific program you've mentioned 
before (March 1986, page 210) from Qlen Bredon 
($40, 521 State Road, Princeton, lU 08540), it's a 
piece of cake. I don't have a hard disk but Glen's 
program works ^t with the extended SOcolumn 
card on my He. ^nce I write programs by the old "trial 
and error" method, compiling to /RAM has saved me 
a lot of time. Compiling to disk for every one-character 
change you make to your program can put ^u over 
the edge veiy quickly. 

The disk is not copy-protected. This is a big plus in 
my book. 

Support for the program has been excellent Call 
Micol Systems and you get the autiior. 

The only weakness for me is the editor. Because of 
my "brute-force" method of programming, it would 
be nice if tiie editor contained a renumfcier facility. A 
Micol Basic renumber program is Included in the 
Appendix of the manual but I find it too time- 
consuming to leave the editor, renumber, and then 
return to tiie editor. 

I believe strongly in supporting programs tiiat give 
you your money's wortti experience shows tiiat 
few programs live up to tiie daims of tiieir autiiors or 
marl^eting people. NioofBasicis an excellent program 
ataveryfair price and delivers as promised. 

JackCowly 
Temple Cify, Calif. 

As you mention, nicol Basic is not strictly an 
Apj^esoft compiler. It is an enhanced version of 
Basic with an Applesoft-itke syntax. It is pri<xd right 
at $49.95 plus $5 s/i(ppOtg and fiandting (Micol 
Systems, 9 Lynch Hd, Toronto, OlfT, Canada M2J2V6 
41&495SB64). Our techrdcal wizard Dennis Doms 
has taken an extend look at fHcol Bade and 
here's what he thinks: 

Micol Systems claims in its advertising that "Micol 
Ba&c is capable ofcompilingyour&dstingApplesoft 
programs. . . ."As long as you take ^capable" to mean 
something less than fully compatible, you will not 
be fooled by the ad. Most non-trivisd Applesoft 
programs have to be modified somewhat before 
they can be compiled with Med Basic. The mod^ca- 
tions center on differences in disk I/O commands. 
There are ateo a few syntax differences and the 



compiler requires a few commands of its own In 
addition, Applesoft files have to be converted to text 
files before compilation can begin, 

Micol Basic supports signiftcant enhancements to 
Basic such as the structured programming commmds 
WfllLE-WEm, REPEAT-UmiL BEQlH-EHDm and so 
on. Micol Basic also supports ' typing" of variables 
(you can defme all variables whose names be0n 
with the letters I-H to be integer variables, for 
example). A new variable type allowed by Micof is 
boolean In addiUon Mkxti Basic st^ports long 
variable names such as BLOODYJjOnGJmE (this 
feature can be disaWed), and CtlAlUlng ofpmgrams. 

Someofthe$yntaxc^gesarecosmekc,probat)ly 
to ease the Job of the compiler program. One of the 
more prominent of these is that the arguments of 
VTAB and fTTAB have to be in parentheses or you will 
get an error during compilaUon. Also, DATA must be 
declared pnor to its reference by REM), immediately 
after any compiler options (so you wanted strudure 
in your programs?...). 

While browsing through the manual and reading 
about these features, I started getting enthused. The 
loss" of Applesoft compatibility may be wmpensated 
by the extra features: speed and structure. 

The development cycle is the usual compiler 
shuffle -EDIT the text fUe that holds the program 
source code, saue the source file, COMPILE the 
sowce fUetoan object fUe, UfiK the objed fUe to the 
compiler's library to form an executat)le objed file, 
load the mn-time support package and EMCUTE the 
executBble object file. In case of an error at any 
stage, go to the beginrung and statt over, nonetheless, 
I found the MiaA emnronment easy to work in. 

To bring up Micol from a subdirectory you must 
call it by the complete pathname leading to it for 
example, on my disk I had to use ''-/PROG/ 
MICOLBASIC/MICOLSYSTEM." Doing the normal 
ProDOS move of setting the prefix to JPROQ/ 
MICOLBASIC" and then issuing ' -MICOLSYSTEM" 
exiled me to the ProDOS quit prompt This and a 52- 
character limit on filenames used within programs 
gives the impression that Micol's author, Steve 
Brunler, isn't yet sold on subdirectories. 

I transferredacopyofLITn£BRIO{OlTr(acias^ 
ApiAesoftgame sup0ed on the old DOS 3.5 System 
Master) over to my work disk and saved it as a tejd 
file (if you don't know how to do this, the Wicoi 
manuaf explains how). UTTLE BRICh OUT was 
chosen as a guinea ptg for conversion since it was 
mentioned in the fUcol Basic manuai and fn a 
SoftaSk (Sept BSl ps^es 95-102) article euaiuaOr^ 
Applesoft compilers. It is also a moderate-sized 
program; after converting it to ProDOS it used 15 
blocks. Converting it to text gave a file size of 22 
blocks. Editing it to facilitate compilation added one 
more block. I did the minimum amount of editing 
needed to allow the file to compile and run. This 
primarily entailed changing VTAB and tfTAB state- 
ments, re-defining logical IF statements of the type 
"if var TMEU" to comparisons of the type lFvar< > 
TflEfi", and keeping LITTLE BRICK OUTs PORE 
dements from tromping on Micol's use of 768-815 
($300452r). 

The Micol editor is a limited but usable line- 
oriented text editor. I used the editor's F)ind and 
R)eplace commands to fmd most syntax problems, 
neither command includes a wildcard optbn so 
tryir^ to find aitd replace all occurrences of VM 
<number> for all pos^nities of<numbef> got a bit 
tedious. It's easier to do conversions from Applesoft 
by using Apple iUiter to do the searching and 
repladng. (In fad a good WPL program could turn 
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Apple Writer into a stand-alone preprocessor,) An 
immediately needed change in is the ability to 
renumber lines from within the editor (yes, Micol 
Bask still requires line numbers for all lines). 

When I got tired, I let the compiler try to fmd the 
remaining offenses. During four compiles I noticed 
that compile errors for certain lines were not always 
reproducible. One example: during the 5rd compila- 
tion I got an error in line 970 (for an improper W 
syntax) that was not caught in the second compilation, 
line 2947 had a missing Y between strings in a 
print statement Line 5010 gave an error over some- 
thing about a ^rint statement" (there is no FHIHT 
statement in line 3010 of LITTLE Bfi/CK OUT). 1 
correded lines 970 and 2947 and fed it to the 
compiler a fourth time, hoping for a recurrence of the 
message given for line 5010. This time it compiled 
with no errors to an output code file of 20 blocks. 

In addition to that 20 blocks, we have to have a 21 
block run-time program called LIBRARY incited. 
This replaces the ProDOS command interpreter, 
Basicsy^em. FefMdngBasicsystem with the library 
is good in the sense that it saves memory space, but 
it's bad in the sense that you can't enter ProDOS 
commands on the keyboard when you exit a Wicol 
BaMC program. And if you enter a FroDOS command 
by mistake at that point Micol Bask sometimes 
crashes. 

Forwhatit's worth, Softalk reported that Microsoft's 
DOS 5,5 TASC compiler produced a 59 sector file 
(about 20 blocks) uMen compiling LTTTLC BRICH 
OUT, and required a 17 sector (9 blocks) run-time 
package (in addition to all of DOS 5.5), 

The editAink/compile/execute procedures went 
very quickly. The program linked fine and ran fast 
Once execution has fiiushed, you use the "fir" com- 
mand to return to Micol Basic. 

Thus encouraged, I decided to run a benchmark to 
check the speed. I chose Jim Gilbreath's 'sieve" 
benchmark from Byte ( ^Eratosthenes Revisited", 
Jan. 1985, pp. 285-526). The IBM Basic version 
seemed suited to Mkol Basic's extra constructs. I 
typed it in, adding a Une for the program name and 
changing "10 DEriNTA-r to Micois "10 IHT (A-l): I 
called the compiler. It told me I was out of simple 
array space in line 10. 

It hadn't registered with me that the assignment of 
variable space was not fully dynamic; one of the 
compiler options allows (nay, requires for this 
program) the programmer to assign pointers that 
determine how much memory space is to be reserved 
for simple variables, simple strings, varmble arrays, 
and string arrays. I adjusted these to give simple 
arrays the lion's share of memory. The program 
compiled, and executed in 476 seconds. For compar- 
ison, I timed the same program under standard 
Applesoft at 5764 seconds. That /otics, is a good 
improvement even considering the fact that bench- 
marks sometimes don't tell the whole story, 

Wicol Basic also has a QUICFi compiler option, 
which produces code somewhat optimized for speed 
at the expense of some memory efficiency. The sieve 
program, compiled umg tills option, ran in 444 
seconds and was 429 bytes in size (before linking) 
compared with 476 semnds and 595 bytes for the 
standard mode. 

I did a simple FOR-IiEXT loop from 1 to 10000 In 
Micol Basic and Applesoft With a floating-point 
counter, Micol took 10.5 seconds (versus Applesoft's 
19.9); with an integer counter it took only 4.1 
seconds (Applesoft does not allow integer counters 
in FOR-FIEXT loops). The Micol manual suggests 



using integer variables when possible for maximum 
speed. 

Finally, I did a test with the Savage benchmark 
from the Btjte Special IBM /ssue Fall 1985 (page 
70). This benchmark is supposed to test the efficiency 
of floating-point math routines. Under standard 
Applesoft the test took 472 seconds; Micol took 465 
seconds. As you can see, Micol does not greatly 
speed up floating-point operations. 

The Applesoft/Micol Basic syntax incompatibilities 
that exist and the necessity of switching system 
interpreters to go from Micol Basic to Applesoft 
makes Micol less than ideal for what I perceive most 
people want an Applesoft compiler for —to quickly 
compile an interactively debugged Applesoft 
program. 

tlowevei looked upon as a separate langmge 
from Applesoft, Micol becomes a lot more atfractiue, 
especially at the price. Emn the licensing fees for 
usingMicoTs nm-time package in commercial softuwe 
are low— free with screen credit to Micol, MicoTs 
nearest competition in Appledom at present is Kyan 
Pascal, which is more sophisticated but also has 
been around longer, Micol is stiff Basic, line numbers 
and all, which may be a plus in finding an audience. 
For someone who wants to stay with a dialect of 
Basic, who wants speed, and who wants the ability 
to write structured programs, Micol is definitely a 
noteworthy and inexpensive solution. 

ProBasic, Logo 

I have not yet seen in your pages (nor hardly 
anywhere else) mention of the fine programs coming 
out of The Software Touch, by the talented authors 
Mark Simonsen and Alan Bird. In particular. Alan's 
FroBasic (distributed as a "freebie" on the back of 
Program Writer) bids fair to totally transform the 
experience of programming in Applesoft. 

ProBasic allows you to add new commands and 
functions called modules to your programs. Each 
module has its own set of local variables, so variable 
conflicts are easier to avoid. Parameters can be 
passed to the modules by value or by reference (even 
by reference to another module). The modules can 
be written In either Applesoft or assembly language 
—thus adding a natural consistent interface for 
machine language routines (look Ma, no &f ). 

That's power, and it's pretty! Best yet, there Is 
nothing to unlearn— nearly every bit of the special 
Apple 11 lore 1 have accumulated over the years is still 
relevant Programming in ProBasic is the next best 
thing to programming in APL (another story, for some 
other time), or at least it promises to be if Alan can get 
the bugs out 

! have one question to ask, concerning sources of 
information on Apple Logo //, which you mentioned 
once or twice in Open-Apple. TWo years ago I wrote a 
review of this product for (alas) the now-defunct 
Microcomputing, and in the process acquired a 
review copy I have never since, however, seen a 
whisper of published evidence tiiat anyone is devel- 
oping applications in Logo //. 1 dig out my copy now 
and then and play with it a bit and admire it all over 
again. The main problem 1 have is tiiat my computer 
is an Apple lie and my printer an Epson MX-80 and 1 
have not been able to find any way to generate hard 
copy directly and convenientiy (the name of the 
game!). I would greatly appreciate your pointing me 
to a printer driver 1 could patch in, or even a few dues 
as to how 1 could approach developing such myself. I 
am not a technical whiz, but could it t>e tiiat this is 
anotiier case of a project that would not be impossibly 



Vbl2,ISo.8* 

*Last month's issue was really No. 7 

complicated if just a littie open information were 
available? 

RW.W. Taylor 
Rochester, n.Y 

It's interesting that you mention FroBasic and 
Logo in the same letter. The way FroBasic allows 
you to write modules and call them by name with 
parameters is very Logo-like. 

To tell you the truth, I hadn't noticed FroBasic 
(hidden away as it is on the back ofFrogmm Writer) 
till I got your letter and I still haven't had a chance to 
use it, but the documentation is absolutely startling. 

/Yot only does FroBasic provide modules, it has a 
command caffed VIKTUAL that allows arrays (both 
numeric and string) to reside in disk files. This 
means the size of an array is limited only by the 
amount of room on your ''disk." You wouldn't want to 
use a floppy for a YIKTUAL array, but this fs one good 
way to use large /HAM disks from Basic. A hard disk is 
also a possibility for really large arrays— and you 
don't have to mess around saving the data in the 
array in a separate file. 

Bird and Simonsen started The Software Tbuch 
afjout a year ago. They are well known as the 
authors of such Beagle Bros classics as Beagle 
Graphics, Extra K Double-Take, and D Code. 

They currently have four m^'or produds. Font- 
Works ($49.95) reads and prints standard text and 
AppleWorks files in a variety of fonts, type styles, and 
sizes. It can print spreadsheets sideways. It has an 
AppleWorkS'like interface and comes in both FroDOS 
and DOS 5.5 versions. It runs on any Apple II. 

Graphics Fro ($29.95) is a single high-resolution 
graphics program like nouseFaint, only better. It 
allows you to work with the entire screen, supports 
graphic t^^lets and joysticks as weU as mice, and, 
unlike MouseFaint, can show you a disk catalog. 

AutoWbrtcs ($59.95) adds macros to /^plem>rks. 
The macros can be updated from within AppleWorks, 
can use conditionals, can contain lists (where each 
time you use the macro it takes the next item from 
the list), and support date and time stamping. The 
program includes a buHt-in mail merge capability, 
adds mouse control for cursor positioning and menu 
selection, and has a file organizer tiiat reads the 
filenames from all the diredories and subdirectories 
on a FroDOS disk into an AppleWorks data base file. 
Alan is working on, but has not yet accomplished, 
Finpoint compatibility. 

i^rogram Writer ($49.95), be^des including Fro- 
Basic for free on the bacK is an AppleWorks-like full- 
screen editor for Applesoft. Using Frogram Writer is 
a lot like writing a program using the AppleWorks 
word processor, except that it has additional features 
such as the ability to renumber lines, the ability to 
list all Vie variables in the program you are editing, 
and the ability to instantly disappear, leaving your 
program in memory ready to run After running your 
program, entering returns you to the editor with 
your program intact. 

In addition to these four main products. The 
Softivare Tbuch also has two disks of additional 
modules for FroBasic at $20 each. Their stuff is 
available at about 200 dealers around the country, 
or by mail order (9842 tiibert St, #192, San Diego, 
Calif 92151 619^549^5091). 

I asked Alan what kind of bugs you were talking 
about in FroBasic. He said an early version had 
some bugs in the VIKTUAL command and in the code 
that saves modules on disk. These have been fbced — 
if you send him your original disk and $5 with a note 
that you wantFroBam updated, he will take care of 
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it for you. 

I'm not sure what your printer problem is with the 
Epson/Apple Logo 11 combination. The Logo H 
commandfortumingonaptinterisOFEMl SmilUTE 
1 if your printer isn't attached to slot one use the 
correct slot number instead. Any Pmm TYPE, or 
SfiOW statement will now go to your printer. Return 
to the screen with CLOSE 1 SETWRITE ( ]. 

If what you want to do is print a listing of your 
program, however, OFfiff 1 SHl/mTE 1 doesn't 
work, instead, use DBIBBil; 1 POALL MODmBLE. 
The Apple lA>go II documentation gets a negative 5 
stars for its explanation of this one (I had to call tech 
support at Logo Computer Systems, developers of 
Apple Logo II, in Quebec-514-631-7081-to find 
the solution, which is hidden on page 210 of the 
reference manual under the discussion of DRIBBLE). 

Some Logo users have had problems with line 
length when listing programs. These problems can 
sometimes be fixed by changing the interface card 
setting for line length with a control-! command. Use 
a Logo command line such as (TYPE CfiAR 9 "AX 
CfiAR 15), with XX equal to the command you want 
to send. See your interface card manual for the 
command you need. For the Apple Super Serial Card 
try X." Unfortunately, you can't send commands to 
some Interface cards, such as the Grappier. because 
Logo II prints CHAR 9 (control-!) with the high bit 
clear and the Grappler expects the high bit to be set 
The Movember 1985 issue of Open-Apple has more 
informaUon on this problem. 

7b discmer why no one is developing applications 
in Logo, load and run the sample programs that 
come with Apple Logo II 6502 versions of the 
language simply can't execute fast enough for 
typical computer applications. liote that the disk is 
copy protected and tfiat /Ippie has made no prcmlmns 
for licensing a Logo II ''run-time" package. This 
means anyone who purchased a Logo II application 
would also need to buy Logo II Itself. TTie primary 
use of Logo is in education, where most people 
consider it not so much a computer language as a 
language or model for learning. 

if you re interested in further information on Logo, 
check out ITieiYatioftaliogo Exdmnget The Logo 
newsletter for Teachers ($25 for nine monthly 
issues. Sept through May, P.O.Box 5341 Chariottes- 
vllle, Va. 22905). It has been putiii^ed^nce Septem- 
ber 1982 and is the most con^rehensive Logo 
publication I know of. Its long suit is educational 
theory but it also Includes solutions to programming 
and technical problems. 

The ampersand solution 

Anyone vAio does any programming at all shouldn't 
miss Roger Wagner Publishing's offer of a free copy of 
the The Dial Size Tbolbox made in the April Qpen- 
Apple, page 2.22. 

I had a veiy interesting talk with Roger the other 
day, and I thought many of Open-Apple's readers 
would be interested. I had noticed that not all of the 
original Kowtine Machine series was upgraded into 
Toolbox packages, so I called to find out why 

Apparently the return rate on registration cards 
from the old Routine Machine programs was rather 
low. Many original owners may not realize it, but 
Roger Vlfeigner Publishing does have an upgrade offer 
for original purchasers. Even if you haven't mailed in 
the registration card, you can mail in the title page 
from the manual as proof of purdiase along with $20 
(plus $3 shipping) and ttenefit from the upgrade. The 
Toolbox series is not protected, as was the original 



Routine Machine, and several newroutines have been 
added and others upgraded. 

The Tbolbox series is designed for programmers! 
Roger says that large ads in computer magazines do 
not provide the same return for this series as they do 
for application programs (i.e. MouseWrite). The result 
of all this Is that a limited numtier of people have 
purchased the Toolbox packages, either new or 
through updates, and Roger has no plans to release 
frirther disks in the Tbo/lKMr series, even though they 
have over 150 additional routines that could be 
released. 

So fellow programmers, order those disks, and tell 
Roger that there is an audience out there that is 
interested in more routines. Mayl)e we can convince 
him to release another disk. 1 for one want to be first 
on the mailing list as I have been using many of these 
routines for some time now, and wonder how I could 
program without them. The routines give a professtonal 
appearance to your programs while simplifying the 
coding. 

Open-Apple is directed at the same audience as 
the Toolbox series. So if you are reading this and you 
don't presently use the Toolbox, you would probably 
be interested in these programs. There are routines 
for all those items you would like to have in your 
program: IF-THEli-ELSE, FRIfiT USlflQ, CATALOG 
READ ROUTIMES, INPUT ROUTINES, OUTPUT ROU- 
TINES, SCREEN f ORMAHING, SORTING ROUTINES 
and more. DonDruce 
Longueuil, Quebec 

Roger's offer of a free Ttial Size Toolbox to any 
Open-Apple reader who writes in and asks for one is 
still open. (Roger Wagner Publishing, P.O. Box 582, 
Santee, Calif 92071) The four toolbox paclmges 
currently avsdlable are The Wizard's ToMox, The 
Database Toolbox, The Video Toolbox, and The 
Chart 'n Grs^h Toolbox, Each sells for $59.95. 

The routines can be used in commercial software 
without a licensing fee. You do have to write in for a 
formal licertse agreement however, and include a 
credit line in your finished software. The Tbolbox 
packages are shipped on DOS 5.5 disks, but all 
readily COIWERT to ProDOS with the exception of the 
Chart'n Graph Toolbox, which is available by 
request In a ProDOS version. 

Routines from the various Toolbox packages are 
all compatible with each other. They share the 
ampersand hook. The beauty of the Toolbox series 
is the way the ampersand hook and memory require- 
ments are automaticadly handled by the package. 
Tihe necessary machme language code is attached to 
the end of Applesoft programs where it stays per- 
manently. PloBLOADS, buffer moving, orGETBUrPER 
calls are required. 

Another pixe for code 

In the July issue (pages 2.43-44) you "released the 
power to everyone" by showing how to embed machine 
language in a REM statement as an alternative to 
using memoiy page three. You also mentioned that 
method was ONE way to do it I think it's a little too 
restrictive — the machine code cannot contain a zero, 
it cannot exceed 239 bytes, and it LISTs as garbage 
on the screen. I have always hidden my machine 
language code at the end of a program, between the 
last line and the variables. 

I can't take credit for inventing this method, but I 
will do my part in "releasing the power" and share it 

The only restriction that 1 know of with this method 
is that the machine code must be relocatable (no 



reference to locations inside itself). It will work with 
either ProDOS or DOS 3.3. 

1. ClEar the machine: 

NEW (or FP under DOS 3.3) 

2. LOAD your BASIC program: 

LDflD MY.PRDG (you can skip this step if 

your program isn't written yet) 

3. Get the current program end: 

PE = PEEK(17G)*25G + PEEK(17S) : PRINT PE 

4. Load the machine language code onto the end; 

BLDflO ML.CQDE,m>:X 

(use the value from step 3 for XXXX) 

5. Calculate the new program end: 

PE = PE + length of ML. CODE 

S. Change the pointer to the neu program end: 
POKE 176, PE/2SG : 
POKE 175, PE - PEEK(17£)»2SG 

7. Save it: 

SfiVE MY -NEW. PROG 

You may add, delete, or edit your Applesoft lines as 
you wish. You should be able to use your favorite line 
editor as usual. You can use EXEC to add program 
lines or even to add whole programs to a machine 
code skeleton file. 

As you edit the Applesoft program, the machine 
language segment is moved up and down in memory 
automatically when the program gets longer or 
shorter. To find its address during program execution, 
add this line when you set up your variables: 

flLflDR = PEEK ( 176 )*25G + PEEK (175) - 
length of ML. CODE 

Then, when you need to CALL the routine, simply 
CALL MLADR. ^^^^ Stephenson 

Checkmate Technology, Inc 
Tempe,Ariz. 

for those of you who have been following my 
series on tricks with Applesoft in the April, June, and 
July issues, here's a little more detail on how this 
method works. 

Look at one of the memory maps from those 
issues— on Aprils page 2.19 or June's page 2.55. In 
this technique, the machine language code is added 
to the end of the program image "— the second area 
from the top in the memory maps. 

In between the Applesoft program and the machine 
language code there are three zeros. This method 
works because some parts of Applesoft consider the 
three zeros to mark the end of the program while 
other parts use the PRGEliD pointer at 175-176 ($Ar- 
BO) to mark the end of the program. 

The genie that executes programs uses the three 
zeros. Thus, that genie never tries to execute the 
machine code as if it were Applesoft tokens. The 
genie that corrects the "nexf-Hne pointers" also uses 
the three zeros. Thus, that genie doesn't go searching 
through the machine code looking for the zero bytes 
that mark the end of Applesoft lines. If she did, she 
would try to ''fix" the next-line pointers and, as a 
consequence, trash the machine code. 

On the other hand, the genie that moves Applesoft 
programs up and down in memory as lines are 
added or deleted uses PRGEliD. Because of this, the 
machine code segment essentially becomes "stuck" 
to the end of the Applesoft program image. The SAVE 
and LOAD commands also use PRGEtiD, so the 
machine code segment automatically follows the 
program in and out of disk files 

The only difficulty with this technique is that if you 
have more than one piece of machine ccKie, you have 
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to keep track of the exact length of each and do some 
cateu(attons to figure out where in memory they end 
up. Roger li'agner's Toolbox series automates this ' 
difficulty and makes it easier for routines written by 
d^erent people to share this memory resource. 

The Integer version 

Since I'm probably one of the few people around 
that even remembers there was such a thing as 
Integer Basic, I tiiought I would add to your reply to 
the letter from l^n Lipshultz (July, page 2.44) about 
the mysterious appendix at the end of AFFLEVISiOII. 

An Integer BASIC program is stored downward in 
memory from thehi^est available location, less one, 
as defined by HIMEM: (76-77, $4C4D), while the 
variable table builds upward from $0800. In Integer, 
when the HIMEM: command is used, a memory move 
is executed and the program is relocated with its last 
byte at the new location of HIMEM:-X 

lb attach a machine language progranxjust calculate 
the amount of space required for the code to be 
added and lower HINEM: appropriately using the 
tllMEM: command. Then type in or BLOAD the binary 
data. Remember where it starts as this becomes the 
permanent starting address for the routine, finally 
restore the HIMEM: pointer to its original setting— 
this time using POKE rather than the HIMEM: command 
—and save the program. When you list the modified 



program you will d course, sec a bunch of garbage at 
the end. 

ValJ.Qolding 
tozana, Calif. 

Problems w'rth splits 

Your article on splitting Applesoft programs in the 
April issue was great (pages 217-2.21). Ifs hard to 
imagine that there could be any more to say on the 
subject but here are some solutions to problems I've 
encountered with split programs. 

In All About Applesoft (page 118), David Ungwood 
points out that Applesoft does a limited check of its 
current position in a program when a GOTO or 
QOSUB is executed. If tiic high byte of the destination 
line number is greater than tiiat of the current line 
number, Applesoft begins searching for the new line 
fiom tiie present line, rather tiian going all the way 
back to the beginning of the program. 

In your example, line 9999 changes its own next- 
line pointer and then says GOTO 10000. Change this 
to GOTO 10240 or more and the program will crash 
with an UriDEfD STATEMEMT error. You can be sure 
that a split will work with any combination of line 
numbers (as well as get a bit faster operation) by 
ending the first segment with a dummy line. The on^ 
function of this dummy line is to hold a modified 
next-line pointer tiiats aimed at the second program 
segment Try these modifications to your example at 
ttie top of page 2.21: 

9980 RDR ^ 16384 : REM adr of overlay 

9981 HI = INT((ftDR+l] / 256} : 
LO = (flOH+1) - (HIK25G) 

9982 HERE = PEEK(121) + PEEK(122)»25G : 
NXT= PEEK(HERE+1) + PEEK(HESE+2)»25B : 
POKE NXT,LO : POKE NXT+1,HI : 

GOTO any line nunsber in second segment 
9999 REM dummy line 

Another problem is tiiat the DATA pointer at bytes 
125-126 ($7D-7E) won't jump the gap between tiie 
two parts of a split program. You have to help it across 
— otiientfise trying to read a DATA statement tiiat's in 
an overlay will return an OUT Of DATA error. You can 
reset tiie DATA pointer when you load an overls^ by 
changing line 9980 (your line 9997) to: 

9988 fiOR = 1G3B4 : POKE 12G. flDR/25G : 
POKE 125, RDR - PEEK(12G)»256 

This metiiod works fine when botti tiie READ and 
DATA statements are in tiie second segment of a 
program. II however, you were simply splitting a 
single big program to stiaddle the graphics pa^, the 
split might occur such that a READ in one segment 
rders to DATA in tiie otiier segment In ttiat case, a 
better tiick would be to acyust tiie DATA pointer in an 
error-handling routine: 

9M0 IF PEEK (222) - 42 THEN 

OP = PEEK (125) + PEEK(12G)«2SG : 
IF DP < ADR THEN POKE 12S, flOR/25G : 
POKE 125, flDR-PEEK(12G)»25G : RESUME 

A final note— there is a very hancty Monitor routine 
at -327 ($rEB9). It allows you to call assembly 
language routines from ^plesoft with tiie 6502's 
registersloadedwifliwhatevervalues you wish. POKE 
tiie value you want in A into byte 69 ($45), X into 70. Y 
into 71 and P into 72. Put tiie address of tiie routine 
you want to execute into bytes 58 and 59 ($3A-3B). 
Then just CALL -327 This enby point is psut of tiie 
Monitor's GO command. 

Paul nix 
Summitry 
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A new formal 

How can 1 format a ProDOS disk from wittiin an 
assembly language program? 

Rol>ertC Moore 
Laurel, Md. 

There are two ways togo. Apple will Ikenseyou its 
ProDOS FOmAnm routine for $50 a year per 
application—see our My Issue, pages 2A142 for 
more information. 

Much more inlerestir^isapublkdomsdnprogram 
called ngperJOmXi by Jerry fieweU. Jt comes 
with source code so you can modify it to your needs 
or include it in your own programs. 

HypenFORMAT is a product of Uving Legends 
Software, which is a loose association 0/ "user 
supported" Apple programmers who have pooled 
their resources and enthusiasm to estsdilish market 
recognition. Vser supported" software, also known 
as 'freeware," can be copied and distributed by 
anyone without charge. Anyone who decides to 
keep and use a freeware package, however. Is 
expected to pay the program's author. BiU Bantam, 
author of Diveni'DOS, has used this method of 
distribution /or j/ears. 

HyperJQRmx however, isn't freeume, but is 
one of several public domain progmm ^ IMng 
Legends authors have put together on a disk they 
(3Ml^DkkM($10^mMngLegendsSofhme, 
1915 Ftoude St. San Diego, Calif 92107 619-222- 
5722). Two other programs on this disk, 
TME.EXECirnVE and UmCOFY, were mentioned in a 
letter to Open-Apple in February (page 2. 7). Uving 
Legends Software's programs can be downloaded 
from the Apple 11 libraries on CompuServe, Delphi, 
and BIX, as well as many local bulletin boards. Or 
you can write them and ask for their catalog of 
interesting, reasonably-priced commercial programs. 

Basis 108& Amiga 

You have mentioned both ttie Ftanldin and the 
Lazer 128 in recent issues-tiiere is anotticr legal 
Apple<ompatible on tiie market altiiough it is 
relatively hard to find in ttie ttie Wsst Qerman 
Basis m 

Altiiough Basis has no formal distributor in tiie 
U.S„ our company acts as an importer and dealer to 
ttie many Basis user groups scattered al>out Vfe also 
act as a source and clearing house of botii Apple and 
CP/M soffavare and hardware that can use the full 
capabilities of tiie Basis. 

YouVe also mentioned the Amiga, and I certainl) 
won't argue witii your assessment of Commodore's 
business healtii, As an old-time hardware engineer 
however, 1 must say tiiat tiie Amiga first shuck me as 
tiie machine Woz would have designed if he had dom 
ttie first Apple from scratch in 1985. Its certainly tiie 
first machine since tiie original II ttiat shows tfie sort 
of engineering elegance, cleverness, and versatility 
ttiii inade our beloved Apples (and my Basis— grin) 
so near and dear to our collective hearts. If Apple had 
managed to get rid of Jobs earlier, majibe ttiey, 
instead of Commodore, would have bought ttie 
Amiga from Intermedics. The tiiought of tiie Amiga 
witti Apple's name, furtti^ developed by Woz and 
some of the others vAio were chaised away in ttie 
yuppifk:ation of Apple brir^ tears to my eyes. 

Bob Stout 
Sjpbionic Systems, Inc 
P.O. Box 428 
Alief, Texas 77411 
713-465-9090 
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